去年參加鐵人賽時,我花了 30 天陪大家從零開始學 n8n。
做完之後,我一直在想:如果 n8n 不只照著流程跑,還能像同事一樣查資料、整理工作,會是什麼樣子?
剛好 n8n 在 2026 年 8 月推出了 n8n Agents,我想用這個新功能,實際做一位 n8n AI 同事。
不過,我不想做一個只會回答「好的,沒問題」的聊天機器人。
我想知道的是:
這個系列會用 30 篇文章,記錄這位 AI 同事的實作、失敗和驗收過程。
如果你用過一般的 n8n Workflow,可以把它想成一張事先寫好的 SOP:收到表單後先整理資料,接著判斷條件,最後寄出通知。每個節點要做什麼、下一步往哪裡走,都是我們先排好的。
n8n Agent 比較像一位拿著 SOP 的工作分派員:你先告訴它目標和規則,它會看懂這次的要求,再決定要不要使用工具,以及該使用哪一個。
你提出任務
↓
Agent 讀取 Instructions,先確認工作規則
↓
Model 判斷要回答、追問,還是呼叫 Tool
↓
Tool 查資料或執行 Workflow
↓
結果回到 Agent,再整理成你看得懂的回答
這裡有兩件事很容易搞混:
第一,Agent 不等於 Model。Model 是負責理解文字和判斷下一步的大腦;Agent 還多了 Instructions、Tools、Memory、Knowledge 和可以接進 Slack 的 Channel。
第二,這次的新功能叫做 n8n Agents,不是 Workflow 裡原本就有的 AI Agent node。原本的 AI Agent node 只存在某一條 Workflow 裡;新的 Agent 有自己的頁面、Session、Draft/Published version,同一位 Agent 也可以同時被 Workflow、Slack 或排程使用。
| AI Agent node | n8n Agents | |
|---|---|---|
| 放在哪裡 | 某一條 Workflow 裡 | 專案裡獨立的 Agents 分頁 |
| 設定能否重複使用 | 跟著該 Workflow | 同一位 Agent 可供多個入口使用 |
| 對話紀錄 | 要自己接 Memory | 內建 Session history |
| 上線方式 | 啟用 Workflow | Preview 後 Publish |
| 人類核准 | 可在 Tool 連線加入 Human review | 可在敏感 Tool 設定 Require approval |
兩者都能做人類核准;差別在設定入口與使用方式。AI Agent node 的做法可參考官方 Human review 說明。
打開 Agent Builder 後,先認得下面幾個區塊就好:
| 部分 | 小白版說明 | 這次怎麼使用 |
|---|---|---|
| Name | 這位同事的名字 | AI 專案營運同事 |
| Model | 負責理解要求與選擇下一步 | 使用自己的模型 credential |
| Instructions | 工作說明與不能碰的紅線 | 三件工作、三條紅線、固定回答格式 |
| Tools | 它真的能動手使用的能力 | 查進度、查文件、做草稿、建立 issue |
| Knowledge | 上傳給 Agent 查找的文件 | 本系列先用文件搜尋 Workflow,方便檢查來源 |
| Memory | 記住對話內容 | 測試同一個 Session 的記憶與不同 Session 的邊界 |
| Channels | 從哪裡找得到它 | 先用 Slack 範例事件測試資料格式,尚未接真實 workspace |
| Schedules | 什麼時候自己工作 | 先認識功能,本系列不把排程摘要列入完成成果 |
本系列的 Session 隔離測試不啟用跨對話的 Episodic memory。若開啟這項功能,Agent 可以回憶先前對話,測試條件就不同了。
Model 接上之後,還需要有明確輸入、輸出的 Tool,Agent 才能真的查專案或建立 Jira。
它有三份工作,卻需要四個 Tools,因為「準備 Jira 草稿」和「真的建立 Jira」一定要拆開,不能讓 AI 在整理文字時順手就把資料送出去。
| Tool | 收到什麼 | 回傳什麼 | 會改資料嗎? |
|---|---|---|---|
get_project_status |
專案代號,例如 AI |
進度、阻塞、負責人、風險與下一步 | 不會,只讀取 |
search_project_docs |
專案代號與想查的問題 | 文件摘要、sourceId 與來源網址 |
不會,只讀取 |
draft_jira_ticket |
專案代號、標題、描述與驗收條件 | 草稿編號;Day 15 起加入 payloadHash |
只寫入練習用草稿表,不建立 issue |
create_jira_ticket |
已保存的草稿編號 draftId |
練習用 issue key 與建立結果 | 會寫入練習表,所以一定要人類核准 |
本系列先用 n8n 內建的 Data Tables 做一張 jira_issues 練習表,後段再用附有程式碼的本機測試服務練習權限、重試與稽核。真實 Jira Cloud 和 Slack 的接線仍留在上線檢查表,不算這 30 篇已完成的成果。
你現在不用急著理解 payloadHash 和去重編號怎麼寫,可以先把 payloadHash 想成草稿的指紋:內容變了,和原本保存的指紋就會對不起來。但 hash 不能代替權限或核准紀錄;若內容與保存的 hash 都能被改掉,就需要另外的保護。
如果只有一個「處理 Jira」Tool,我們很難知道 Agent 目前只是整理草稿,還是真的送出了資料。
拆成 Draft 和 Create 後,界線就很清楚:Draft 可以重跑,Create 必須核准。人類按下 Reject,流程就停在這裡,不會建立 issue。
這也是整個系列最重要的原則:不要只在 Prompt 裡叫 AI 小心,要把限制做進 Tool、權限與流程裡。
這次我們先專心做好一個角色:AI 專案營運同事。
它的工作只有三件:
它也有三條紅線:
光把紅線寫進 Instructions 還不夠,所以後面會真的去看 self-hosted n8n 裡的 Session、Execution 和 Data Table:按下 Reject 後 issue 數量是不是 0?同一個要求依序重送時會不會建立兩次?重新啟動 n8n 後,原本等待核准的工作還在不在?
我們的目標是做出一個能查資料、準備草稿、在 issue 寫入前等待核准的測試原型,再留下一套可以重考的測試。
實作結果不會每題都漂亮:第一週考核只有 2/5 PASS,後面也出現過 Tool 已寫入成功,Agent 卻回答「被拒絕」的情況。我會保留這些失敗,分開評估流程安全與回答品質。最後的交接結果也會分成「本機證據通過」和「正式環境仍待驗證」,不把它包裝成已能上線的成品。
除了 Agent 本身,我也會把實作時用到的東西整理留下來:
有些日子是在調整 Agent 設定,不一定會新增 Workflow,但會留下 Instructions 或測試題。檔案目前先保存在本地,各篇發布時再列出讀者實際可取得的材料;今天只確認環境與路線,沒有 Workflow 需要下載。
n8n Agents 目前仍是 Preview。8 月的官方公告說明會分批開放,Cloud 從 2.32.3 開始支援;版本到了,不代表每個人的畫面會同時出現。
我原本也打算整個系列都用 n8n Cloud,這樣最多人能直接跟著做。以下是 2026 年 8 月 20 日的觀察紀錄:我新開的 Cloud instance 版本是 2.36.2,Data Tables、Credentials 和 Executions 都有,但 Agents 分頁還沒出現。這張圖不代表今天每個 Cloud 帳號的狀態,請以自己的畫面與官方說明為準:

我一開始還以為自己漏了什麼設定,回頭看官方公告,才發現這個畫面符合當時分批開放的情況。既然如此,就先找一條能繼續做下去的路。
我想了一下,決定不等。
但我不想第一天就停在「過幾天再回來看看」。後面的 Tool、Approval 和 Session 都要真的動手才知道,所以我決定先用 Docker 自架一套 n8n,當成這 30 天的實驗室。
n8n 官方也支援 self-hosted Agents,但版本、模組和沙盒設定要一起確認。Day 2 會依本系列實測的環境,從安裝開始慢慢做;最新限制請參考官方 Agents 文件。
如果你的 Cloud 已經看得到 Agents,可以跳過 Day 2 的 n8n 安裝,先跟做 Agent、Data Tables 與 Workflow Tools。Day 20 的容器重啟,以及 Day 23~25 的本機測試服務,則需要另外準備環境,Cloud 不能直接存取你電腦上的 localhost。
如果和我一樣還看不到,就一起先開這間實驗室。下面兩張圖先讓你看 30 天要做到的方向;它們是後續實作完成後的畫面,不是 Day 1 已經做完的步驟。自架完成後,專案裡會先多出一個 Agents 分頁:

點進去後,可以看到 Model、Instructions、Memory 和 Tools:

接下來會先在這套 self-hosted n8n 裡實作。使用原生節點不代表已經通過 Cloud 驗收;匯入不同環境時,Data Table、credential、sub-workflow 與服務網址都需要重新綁定。
今天先不用建立 Agent,只要確認自己走哪一條路:
create_jira_ticket 一定要先經過人類核准如果 Cloud 看得到 Agents,今天就完成,Day 2 的自架環境可以跳過。
如果還看不到,也可以跟著下一篇,用 Docker 把 self-hosted 實驗室開起來,先確認畫面真的出現 Agents,再往下做。